<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>sprox_desfire_files_c.html</title>
<!-- Source : c:/temp/desfire/sprox_desfire_files.c -->
<!-- Doc generated on Thu Jun 24 12:26:36 2010 by johann on PC_DEV_5 -->
<!-- Generated with ROBODoc Version 4.99.8 (Specific build by PRO ACTIVE - Apr 13 2010) -->
<style type="text/css">
body
{
  background-color: #ffffff;
  color: #000000;
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 9pt;
  margin-left: 60px;
  margin-right: 40px;  
}
table
{
  border-collapse: collapse;
  border-style: solid;
  border-width: 1px;
  border-color: #000000;
  margin-bottom: 12px;
}
td
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 9pt;
  vertical-align: top;
  padding-right: 6px;
  border-style: solid;
  border-width: 1px;
  border-color: #dddddd; 
}
th
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 9pt;
  vertical-align: top;  
  padding-right: 6px;
  border-style: solid;
  border-width: 1px;
  border-color: #000000;
  background-color: #dddddd;  
}
h1
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 18pt;
  font-weight: bold;
  margin-bottom: 36px;
  color: #000000;
  margin-left: -40px;
}
h2
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 12pt;
  font-weight: bold;
  margin-top: 48px;
  margin-bottom: 24px;
  padding-top: 2px;
  padding-bottom: 2px;
  background-color: #dddddd;
  color: #000000;
  margin-left: -40px;
}
h3
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 11pt;
  font-weight: bold;
  margin-top: 36px;
  margin-bottom: 24px; 
  border-style: none;
  border-top-style: solid;  
  border-width: 1px;
  border-color: #cccccc; 
  margin-left: -40px;
}
h4
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 11pt;
  font-weight: bold;
  margin-top: 24px;
  margin-bottom: 12px;  
}
h5
{
  font-family: Verdana, Geneva, Lucida, Arial, Helvetica, sans-serif;
  font-size: 9pt;
  font-weight: bold;
  margin-top: 12px;
  margin-bottom: 2px;  
}
a
{
  color: #0000ff;
}
p
{
  margin-top: 0px;
  margin-bottom: 6px;  
  width: 600px;
  text-align: justify;
}
ul
{
  margin-top: 0px;
  margin-bottom: 6px;  
  width: 600px;
  text-align: justify;
}
li
{
  margin-top: 0px;
  margin-bottom: 6px;  
  width: 550px;
  text-align: justify;
}
tt
{
  font-family: Courier, Courier New;
  font-size: 10pt;
}
pre
{
  background-color: #ffffff;
  color: #000000;
  font-size: 10pt;
}
.NAV
{
  font-size: 7pt;
}
a.NAV
{
  color: #0000cc;
}
.TOC
{
  font-size: 9pt;
  color: #888888;
}
a.TOC
{
  color: #0000ff;
}
.INDEX
{
  font-size: 9pt;
}
a.INDEX
{
  color: #0000ff;
}
.TYPE
{
  font-size: 7pt;
  color: #888888;
}
.ITEM
{
  font-weight: bold;
  color: #000088;
}
.LABEL
{
  color: #000088;
}
.HISTORY
{
  color: #006600;
}
.AUTHOR
{
  color: #006600;
}
.COPYRIGHT
{
  color: #006600;
}
.PORTABILITY
{
  color: #006600;
}
.WARNING
{
  color: #aa0000;
}

.bitinfo
{
  width: 60px;
  font-style: italic;
  text-align: center;
}

.bitnum
{
  text-align: center;
}

.bitname
{
  font-weight: bold;
  text-align: center;
}

.tabitem
{
  width: 100px;
}

.tabname
{
  width: 200px;
}

.tabdesc
{
  width: 450px;
}

.value
{
  font-family: courier;
  text-align: right;
}

.tabsepar
{
  border-top-style: solid;
  border-bottom-style: solid;
  border-width: 2px;
  border-color: #888888;
  font-style: italic;
  text-align: center;
}
</style>
</head>
<body bgcolor="#FFFFFF">
<a name="robo_top_of_doc"></a>
<h3 align="center">TABLE OF CONTENTS</h3>
<ul>
<li><a class="TOC" href="#robo6">Files</a></li>
<li><a class="TOC" href="#robo29">ChangeFileSettings</a></li>
<li><a class="TOC" href="#robo37">CreateBackupDataFile</a></li>
<li><a class="TOC" href="#robo38">CreateCyclicRecordFile</a></li>
<li><a class="TOC" href="#robo40">CreateIsoBackupDataFile</a></li>
<li><a class="TOC" href="#robo41">CreateIsoCyclicRecordFile</a></li>
<li><a class="TOC" href="#robo42">CreateIsoLinearRecordFile</a></li>
<li><a class="TOC" href="#robo43">CreateIsoStdDataFile</a></li>
<li><a class="TOC" href="#robo44">CreateIsoValueFile</a></li>
<li><a class="TOC" href="#robo45">CreateLinearRecordFile</a></li>
<li><a class="TOC" href="#robo46">CreateStdDataFile</a></li>
<li><a class="TOC" href="#robo47">CreateValueFile</a></li>
<li><a class="TOC" href="#robo53">DeleteFile</a></li>
<li><a class="TOC" href="#robo57">DF_ADDITIONAL_FILE_SETTINGS</a></li>
<li><a class="TOC" href="#robo101">GetFileIDs</a></li>
<li><a class="TOC" href="#robo102">GetFileSettings</a></li>
</ul>
<h3>&nbsp;</h3>


<h1><a name="robo6"><span class="TYPE">[Modules]</span><a class="LABEL" name="Files">
Files</a></h1>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./modules.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   DesfireAPI :: File management functions
</pre>
</span><p class="ITEM">COPYRIGHT</p>
<span class="COPYRIGHT"><pre class="COPYRIGHT">   (c) 2009 SpringCard - <a href="http://www.springcard.com">www.springcard.com</a>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Implementation of management functions to create or delete
   files withing a DESFIRE application.
</pre>
</span>


<h2><a name="robo29"><span class="TYPE">[Functions]</span><a class="LABEL" name="ChangeFileSettings">
ChangeFileSettings</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>ChangeFileSettings</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Changes the access parameters of an existing file
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_ChangeFileSettings(BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_ChangeFileSettings(SPROX_INSTANCE rInst,
                                     BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_ChangeFileSettings(SCARDHANDLE hCard,
                                     BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : change succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo101">GetFileIDs</a>
   <a class="LINK_37" href="#robo102">GetFileSettings</a>
</pre>
</span>


<h2><a name="robo37"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateBackupDataFile">
CreateBackupDataFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateBackupDataFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for the storage of plain unformatted user data within an existing application
   on the DESFIRE card, additionally supporting the feature of integrated backup mechanism
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateBackupDataFile(BYTE file_id,
                                            BYTE comm_mode,
                                            WORD access_rights,
                                            DWORD file_size);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateBackupDataFile(SPROX_INSTANCE rInst,
                                             BYTE file_id,
                                             BYTE comm_mode,
                                             WORD access_rights,
                                             DWORD file_size);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateBackupDataFile(SCARDHANDLE hCard,
                                           BYTE file_id,
                                           BYTE comm_mode,
                                           WORD access_rights,
                                           DWORD file_size);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : Backup Data File  succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo38"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateCyclicRecordFile">
CreateCyclicRecordFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateCyclicRecordFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates a cyclic record file
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateCyclicRecordFile(BYTE file_id,
                                              BYTE comm_mode,
                                              WORD access_rights,
                                              DWORD record_size,
                                              DWORD max_records);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateCyclicRecordFile(SPROX_INSTANCE rInst,
                                               BYTE file_id,
                                               BYTE comm_mode,
                                               WORD access_rights,
                                               DWORD record_size,
                                               DWORD max_records);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateCyclicRecordFile(SCARDHANDLE hCard,
                                             BYTE file_id,
                                             BYTE comm_mode,
                                             WORD access_rights,
                                             DWORD record_size,
                                             DWORD max_records);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
   DWORD record_size           : size of one single record in bytes
   DWORD max_records           : maximum number of records
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created successfully
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo40"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateIsoBackupDataFile">
CreateIsoBackupDataFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateIsoBackupDataFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for the storage of plain unformatted user data within an existing application
   on the DESFIRE card, additionally supporting the feature of integrated backup mechanism.
   Using this function, an <a class="LINK_6" href="./sprox_desfire_iso_c.html#robo7">ISO</a> EF IDentifier is specified as well as a legacy DESFIRE File ID.
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateIsoBackupDataFile(BYTE file_id,
                                               WORD iso_ef_id,
                                               BYTE comm_mode,
                                               WORD access_rights,
                                               DWORD file_size);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateIsoBackupDataFile(SPROX_INSTANCE rInst,
                                                WORD iso_ef_id,
                                                BYTE file_id,
                                                BYTE comm_mode,
                                                WORD access_rights,
                                                DWORD file_size);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateIsoBackupDataFile(SCARDHANDLE hCard,
                                              WORD iso_ef_id,
                                              BYTE file_id,
                                              BYTE comm_mode,
                                              WORD access_rights,
                                              DWORD file_size);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   WORD iso_ef_id              : IDentifier of the EF for <a class="LINK_12" href="./sprox_desfire_iso_c.html#robo7">ISO</a> 7816-4 applications
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : Backup Data File  succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo41"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateIsoCyclicRecordFile">
CreateIsoCyclicRecordFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateIsoCyclicRecordFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates a cyclic record file.
   Using this function, an <a class="LINK_6" href="./sprox_desfire_iso_c.html#robo7">ISO</a> EF IDentifier is specified as well as a legacy DESFIRE File ID.
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateIsoCyclicRecordFile(BYTE file_id,
                                                 WORD iso_ef_id,
                                                 BYTE comm_mode,
                                                 WORD access_rights,
                                                 DWORD record_size,
                                                 DWORD max_records);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateIsoCyclicRecordFile(SPROX_INSTANCE rInst,
                                                  WORD iso_ef_id,
                                                  BYTE file_id,
                                                  BYTE comm_mode,
                                                  WORD access_rights,
                                                  DWORD record_size,
                                                  DWORD max_records);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateIsoCyclicRecordFile(SCARDHANDLE hCard,
                                                WORD iso_ef_id,
                                                BYTE file_id,
                                                BYTE comm_mode,
                                                WORD access_rights,
                                                DWORD record_size,
                                                DWORD max_records);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   WORD iso_ef_id              : IDentifier of the EF for <a class="LINK_12" href="./sprox_desfire_iso_c.html#robo7">ISO</a> 7816-4 applications
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
   DWORD record_size           : size of one single record in bytes
   DWORD max_records           : maximum number of records
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created successfully
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo42"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateIsoLinearRecordFile">
CreateIsoLinearRecordFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateIsoLinearRecordFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates a linear record file.
   Using this function, an <a class="LINK_6" href="./sprox_desfire_iso_c.html#robo7">ISO</a> EF IDentifier is specified as well as a legacy DESFIRE File ID.
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateIsoLinearRecordFile(BYTE file_id,
                                                 WORD iso_ef_id,
                                                 BYTE comm_mode,
                                                 WORD access_rights,
                                                 DWORD record_size,
                                                 DWORD max_records);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateIsoLinearRecordFile(SPROX_INSTANCE rInst,
                                                  WORD iso_ef_id,
                                                  BYTE file_id,
                                                  BYTE comm_mode,
                                                  WORD access_rights,
                                                  DWORD record_size,
                                                  DWORD max_records);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateIsoLinearRecordFile(SCARDHANDLE hCard,
                                                WORD iso_ef_id,
                                                BYTE file_id,
                                                BYTE comm_mode,
                                                WORD access_rights,
                                                DWORD record_size,
                                                DWORD max_records);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   WORD iso_ef_id              : IDentifier of the EF for <a class="LINK_12" href="./sprox_desfire_iso_c.html#robo7">ISO</a> 7816-4 applications
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD record_size           : size of one single record in bytes
   DWORD max_records           : maximum number of records
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created successfully
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo43"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateIsoStdDataFile">
CreateIsoStdDataFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateIsoStdDataFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for the storage of plain unformatted user data within an existing application
   on the DESFIRE card.
   Using this function, an <a class="LINK_6" href="./sprox_desfire_iso_c.html#robo7">ISO</a> EF IDentifier is specified as well as a legacy DESFIRE File ID.
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateIsoStdDataFile(BYTE file_id,
                                            WORD iso_ef_id,
                                            BYTE comm_mode,
                                            WORD access_rights,
                                            DWORD file_size);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateIsoStdDataFile(SPROX_INSTANCE rInst,
                                             WORD iso_ef_id,
                                             BYTE file_id,
                                             BYTE comm_mode,
                                             WORD access_rights,
                                             DWORD file_size);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateIsoStdDataFile(SCARDHANDLE hCard,
                                           WORD iso_ef_id,
                                           BYTE file_id,
                                           BYTE comm_mode,
                                           WORD access_rights,
                                           DWORD file_size);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   WORD iso_ef_id              : IDentifier of the EF for <a class="LINK_12" href="./sprox_desfire_iso_c.html#robo7">ISO</a> 7816-4 applications
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : creation succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo44"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateIsoValueFile">
CreateIsoValueFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateIsoValueFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for storage and manipulation of 32bit signed integer values within an existing
   application on the DESFIRE card
   Using this function, an <a class="LINK_6" href="./sprox_desfire_iso_c.html#robo7">ISO</a> EF IDentifier is specified as well as a legacy DESFIRE File ID.
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateIsoValueFile(BYTE file_id,
                                          WORD iso_ef_id,
                                          BYTE comm_mode,
                                          WORD access_rights,
                                          SDWORD lower_limit,
                                          SDWORD upper_limit,
                                          SDWORD initial_value,
                                          BYTE limited_credit_enabled);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateIsoValueFile(SPROX_INSTANCE rInst,
                                           WORD iso_ef_id,
                                           BYTE file_id,
                                           BYTE comm_mode,
                                           WORD access_rights,
                                           SDWORD lower_limit,
                                           SDWORD upper_limit,
                                           SDWORD initial_value,
                                           BYTE limited_credit_enabled);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateIsoValueFile(SCARDHANDLE hCard,
                                         WORD iso_ef_id,
                                         BYTE file_id,
                                         BYTE comm_mode,
                                         WORD access_rights,
                                         SDWORD lower_limit,
                                         SDWORD upper_limit,
                                         SDWORD initial_value,
                                         BYTE limited_credit_enabled);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   WORD iso_ef_id              : IDentifier of the EF for <a class="LINK_12" href="./sprox_desfire_iso_c.html#robo7">ISO</a> 7816-4 applications
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   SDWORD lower_limit          : lower limit which is valid for this file. The lower limit marks 
                                 the boundary which must not be passed by a <a class="LINK_12" href="./sprox_desfire_value_c.html#robo50">Debit</a> calculation on 
                                 the current value
   SDWORD upper_limit          : the upper limit which sets the boundary in the same manner but for
                                 the <a class="LINK_12" href="./sprox_desfire_value_c.html#robo48">Credit</a> operation
   SDWORD initial_value        : specifies the initial value of the value file
   BYTE limited_credit_enabled : activation of the <a class="LINK_12" href="./sprox_desfire_value_c.html#robo110">LimitedCredit</a> feature (0 disabled, 1 enabled)
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo45"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateLinearRecordFile">
CreateLinearRecordFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateLinearRecordFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates a linear record file
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateLinearRecordFile(BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights,
                                     DWORD record_size,
                                     DWORD max_records);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateLinearRecordFile(SPROX_INSTANCE rInst,
                                     BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights,
                                     DWORD record_size,
                                     DWORD max_records);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateLinearRecordFile(SCARDHANDLE hCard,
                                     BYTE file_id,
                                     BYTE comm_mode,
                                     WORD access_rights,
                                     DWORD record_size,
                                     DWORD max_records);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD record_size           : size of one single record in bytes
   DWORD max_records           : maximum number of records
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created successfully
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo46"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateStdDataFile">
CreateStdDataFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateStdDataFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for the storage of plain unformatted user data within an existing application
   on the DESFIRE card
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateStdDataFile(BYTE file_id,
                                         BYTE comm_mode,
                                         WORD access_rights,
                                         DWORD file_size);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateStdDataFile(SPROX_INSTANCE rInst,
                                          BYTE file_id,
                                          BYTE comm_mode,
                                          WORD access_rights,
                                          DWORD file_size);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateStdDataFile(SCARDHANDLE hCard,
                                        BYTE file_id,
                                        BYTE comm_mode,
                                        WORD access_rights,
                                        DWORD file_size);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   DWORD file_size             : size of the file in bytes
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : creation succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo47"><span class="TYPE">[Functions]</span><a class="LABEL" name="CreateValueFile">
CreateValueFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>CreateValueFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Creates files for storage and manipulation of 32bit signed integer values within an existing
   application on the DESFIRE card
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_CreateValueFile(BYTE file_id,
                                       BYTE comm_mode,
                                       WORD access_rights,
                                       SDWORD lower_limit,
                                       SDWORD upper_limit,
                                       SDWORD initial_value,
                                       BYTE limited_credit_enabled);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_CreateValueFile(SPROX_INSTANCE rInst,
                                        BYTE file_id,
                                        BYTE comm_mode,
                                        WORD access_rights,
                                        SDWORD lower_limit,
                                        SDWORD upper_limit,
                                        SDWORD initial_value,
                                        BYTE limited_credit_enabled);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_CreateValueFile(SCARDHANDLE hCard,
                                      BYTE file_id,
                                      BYTE comm_mode,
                                      WORD access_rights,
                                      SDWORD lower_limit,
                                      SDWORD upper_limit,
                                      SDWORD initial_value,
                                      BYTE limited_credit_enabled);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE comm_mode              : file's Communication Settings
   WORD access_rights          : file's Access Rights
   SDWORD lower_limit          : lower limit which is valid for this file. The lower limit marks 
                                 the boundary which must not be passed by a <a class="LINK_12" href="./sprox_desfire_value_c.html#robo50">Debit</a> calculation on 
                                 the current value
   SDWORD upper_limit          : the upper limit which sets the boundary in the same manner but for
                                 the <a class="LINK_12" href="./sprox_desfire_value_c.html#robo48">Credit</a> operation
   SDWORD initial_value        : specifies the initial value of the value file
   BYTE limited_credit_enabled : activation of the <a class="LINK_12" href="./sprox_desfire_value_c.html#robo110">LimitedCredit</a> feature (0 disabled, 1 enabled)
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : file created
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
   <a class="LINK_37" href="#robo53">DeleteFile</a>
</pre>
</span>


<h2><a name="robo53"><span class="TYPE">[Functions]</span><a class="LABEL" name="DeleteFile">
DeleteFile</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>DeleteFile</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Permanently deactivates a file within the file directory of the currently selected application
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_DeleteFile(BYTE file_id);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_DeleteFile(SPROX_INSTANCE rInst,
                                   BYTE file_id);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_DeleteFile(SCARDHANDLE hCard,
                                 BYTE file_id);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : File deleted successfully
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and its
   acceptable parameters.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo46">CreateStdDataFile</a>
   <a class="LINK_37" href="#robo37">CreateBackupDataFile</a>
   <a class="LINK_37" href="#robo47">CreateValueFile</a>
   <a class="LINK_37" href="#robo45">CreateLinearRecordFile</a>
   <a class="LINK_37" href="#robo38">CreateCyclicRecordFile</a>
</pre>
</span>


<h2><a name="robo57"><span class="TYPE">[Types]</span><a class="LABEL" name="DF5fADDITIONAL5fFILE5fSETTINGS">
DF_ADDITIONAL_FILE_SETTINGS</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./types.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>DF_ADDITIONAL_FILE_SETTINGS</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Union for returning the information supplied by the <a class="LINK_6" href="#robo102">GetFileSettings</a> command.
   Use stDataFileSettings for Standard Data <a class="LINK_6" href="#robo6">Files</a> and Backup Data <a class="LINK_6" href="#robo6">Files</a>.
   Use stValueFileSettings for Value <a class="LINK_6" href="#robo6">Files</a>.
   Use stRecordFileSettings for Linear Record <a class="LINK_6" href="#robo6">Files</a> and Cyclic Record <a class="LINK_6" href="#robo6">Files</a>.
</pre>
</span><p class="ITEM">SOURCE</p>
<span class="SOURCE"><pre class="SOURCE">   {
     struct
     {
       DWORD   eFileSize;             //user file size
     } stDataFileSettings;
       
     struct
     {
       SDWORD  lLowerLimit;           // lower limit of the file
       SDWORD  lUpperLimit;           // upper limit of the file
       DWORD   eLimitedCredit;        // limited credit value
       BYTE    bLimitedCreditEnabled; // limited credit enabled
     } stValueFileSettings;
     
     struct
     {
       DWORD   eRecordSize;           // record size
       DWORD   eMaxNRecords;          // maximum number of records
       DWORD   eCurrNRecords;         // current number of records
     } stRecordFileSettings;
   } <strong>DF_ADDITIONAL_FILE_SETTINGS</strong>;
</pre>
</span>


<h2><a name="robo101"><span class="TYPE">[Functions]</span><a class="LABEL" name="GetFileIDs">
GetFileIDs</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>GetFileIDs</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Returns the DESFIRE File IDentifiers of all active files within the currently selected application
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_GetFileIDs(BYTE fid_max_count,
                                     BYTE fid_list[],
                                     BYTE *fid_count);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_GetFileIDs(SPROX_INSTANCE rInst,
                                     BYTE fid_max_count,
                                     BYTE fid_list[],
                                     BYTE *fid_count);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_GetFileIDs(SCARDHANDLE hCard,
                                     BYTE fid_max_count,
                                     BYTE fid_list[],
                                     BYTE *fid_count);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE fid_max_count          : maximum number of DESFIRE File IDentifiers
   BYTE fid_list[]             : DESFIRE File IDentifiers list 
   BYTE *fid_count             : number of DESFIRE File IDentifiers in the selected application
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : operation succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and the
   returned values.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo102">GetFileSettings</a>
   <a class="LINK_37" href="#robo29">ChangeFileSettings</a>
</pre>
</span>


<h2><a name="robo102"><span class="TYPE">[Functions]</span><a class="LABEL" name="GetFileSettings">
GetFileSettings</a></h2>

<p class="NAV">[<a class="NAV" href="#robo_top_of_doc">top</a>][<a class="NAV" href="./functions.html#top">index</a>]</p>
<p class="ITEM">NAME</p>
<span class="NAME"><pre class="NAME">   <strong>GetFileSettings</strong>
</pre>
</span><p class="ITEM">DESCRIPTION</p>
<span class="DESCRIPTION"><pre class="DESCRIPTION">   Get information on the properties of a specific file
</pre>
</span><p class="ITEM">SYNOPSIS</p>
<span class="SYNOPSIS"><pre class="SYNOPSIS">   [[sprox_desfire.dll]]
   SWORD SPROX_Desfire_GetFileSettings(BYTE file_id,
                                     BYTE *file_type,
                                     BYTE *comm_mode,
                                     WORD *access_rights,
                                     <a class="LINK_3" href="#robo57">DF_ADDITIONAL_FILE_SETTINGS</a> *additionnal_settings);

   [[sprox_desfire_ex.dll]]
   SWORD SPROXx_Desfire_GetFileSettings(SPROX_INSTANCE rInst,
                                     BYTE file_id,
                                     BYTE *file_type,
                                     BYTE *comm_mode,
                                     WORD *access_rights,
                                     <a class="LINK_3" href="#robo57">DF_ADDITIONAL_FILE_SETTINGS</a> *additionnal_settings);

   [[pcsc_desfire.dll]]
   LONG  SCardDesfire_GetFileSettings(SCARDHANDLE hCard,
                                     BYTE file_id,
                                     BYTE *file_type,
                                     BYTE *comm_mode,
                                     WORD *access_rights,
                                     <a class="LINK_3" href="#robo57">DF_ADDITIONAL_FILE_SETTINGS</a> *additionnal_settings);
</pre>
</span><p class="ITEM">INPUTS</p>
<span class="INPUTS"><pre class="INPUTS">   BYTE file_id                : DESFIRE File IDentifier
   BYTE *file_type             : type of file (DF_STANDARD_DATA_FILE, DF_BACKUP_DATA_FILE, 
                                 DF_VALUE_FILE, DF_LINEAR_RECORD_FILE or DF_CYCLIC_RECORD_FILE)
   BYTE *comm_mode             : file's Communication Settings
   WORD *access_rights         : file's Access Rights
   <a class="LINK_12" href="#robo57">DF_ADDITIONAL_FILE_SETTINGS</a> *additionnal_settings : information file
</pre>
</span><p class="ITEM">RETURNS</p>
<span class="RETURNS"><pre class="RETURNS">   <a class="LINK_21" href="./desfire_card_h.html#robo77">DF_OPERATION_OK</a>    : operation succeeded
   Other code if internal or communication error has occured. 
</pre>
</span><p class="ITEM">NOTES</p>
<span class="NOTES"><pre class="NOTES">   Please refer to DESFIRE datasheet for details regarding this function and the
   returned values.
</pre>
</span><p class="ITEM">SEE ALSO</p>
<span class="SEE_ALSO"><pre class="SEE ALSO">   <a class="LINK_37" href="#robo101">GetFileIDs</a>
   <a class="LINK_37" href="#robo29">ChangeFileSettings</a>
</pre>
</span>
<hr />
Generated from <b>sprox_desfire_files.c</b> on Thu Jun 24 12:26:36 2010<br />
</body>
</html>
